listview: Introduce GtkListItemFactory

Thisis the abstraction I intend to use for creating widgets and binding
them to the item out of the listview.

For now this is a very dumb wrapper around the functions that exist in
the API.

But it leaves the freedom to turn this into public API, make an
interface out of it and most of all write different implementations, in
particular one that uses GtkBuilder.

gtk: Add a GtkListView skeleton

builder: Add <binding> tag

The tag contains an expression that it then gtk_expression_bind()s to
the object it is contained in.

builder: Allow text content in <lookup>

  <lookup>foo</lookup>
is now short for
  <lookup>
    <constant>foo</constant>
  </lookup>
ie it looks up the object with the given name so it can then do a
property lookup with it.

This is the most common operation, so it's a nice shortcut.

builder: Allow <constant> without a type

A constant without a type is assumed to be an object. This is the most
common case and allows
  <constant>foo</constant>
without requiring updates to the type whenever the foo object changes.

builder: Make <lookup> type optional

If no type is set, use the type of the expression.

gtk-demo: Make fishbowl info text use bindings

It's a good demo for how bindings can format multiple properties into an
informative string with 1 line of code (and 5 lines of XML).

sorter: Add tests

Some basic tests for GtkSorter.

sortlistmodel: Make sort stable

The sort of the sortlistmodel is now stable with respect to the original
list model.

That means that if the sorter compares items as equal, the model
will make sure those items keep the order they were in in the original
model.

Or in other words: The model guarantees a total order based on the
item's position in the original model.

sortlistmodel: Redo the way we store the items

We need to keep this data around for changes in future commits where we
make the sorting stable.

An important part of the new data handling is that the unsorted list
needs to always be dealt with before the sorted list - upon creation we
rely on the unsorted iter and upon destruction, the sorted sequence
frees the entry leaving the unsorted sequence pointer invalid.

This change does not do any behavioral changes.

Redo sort list model with GtkSorter

Reshuffle the api to take full advantage
of GtkSorter. Update all callers.

Add GtkNumericSorter

This sorter compares numbers obtained from items
by evaluating an expression.

Add GtkMultiSorter

This is a sorter that tries multiple sorters in turn.

Add GtkStringSorter

This is a GtkSorter implementation collating strings

Add GtkCustomSorter

This is a GtkSorter implementation which uses a GCompareDataFunc.

Add GtkSorter

This is a helper object for sorting, similar to GtkFilter.

Add GtkOrdering

This is an enum that we're gonna use soon and it's worth introducing as a
separate commit.

The intention is to have meaningful names for return values in
comparison functions.

More expression tests

Test type mismatches, and the this pointer
during evaluation.

expression: Invalidate bindings before destroying them

Use a weak ref to invalidate bindings. Make sure that this happens
before creating any watches, so that notifies from the
watched expression about changes will not trigger set_property() calls
during dispose()/finalize().

Invalidating also ensures that the watches aren't removed, which can
trigger warnings if the watches are watching the object itself, and the
weak refs cannot be removed anymore.

expression: Add gtk_expression_bind()

Add a simple way to bind expressions to object properties. This is
essentially the thing to replace g_object_bind_property().

testsuite: Add expression tests

expression: Add the ability to watch an expression

builder: Add support for parsing expressions

filter: Add tests

Some basic tests for GtkFilter

Add GtkMultiFilter, GtkAnyFilter, GtkEveryFilter

GtkMultiFilter is the abstract base class for managing multiple child
filter.
GtkAnyFilter and GtkEveryFilter are the actual implementations.

filter: Add GtkStringFilter

Users provide a search filter and an expression that evaluates the items
to a string and then the filter goes and matches those strings to the
search term.

expression: Add GtkObjectExpression

Weak refs break cycles...

Add GtkExpression

GtkExpressions allow looking up values from objects.

There are a few simple expressions, but the main one is the closure
expression that just calls a user-provided closure.

filterlistmodel: Rewrite to use GtkFilter

tests: Remove testtreemodel test

testlistview does everything this test does.

Add GtkCustomFilter

Add GtkFilter

Add GtkDirectoryList

Adds a new listmodel called GtkDirectoryList that lists the children of
a GFile as GFileInfos.

This is supposed to be used by the filechooser.

eventcontrollermotion: Remove mode argument

It's not used and nobody has documented how it's meant to work anyway.

Merge branch 'fix-pango-deps' into 'master'

Fix inconsistencies in our pango deps

See merge request GNOME/gtk!1989

Merge branch 'matthiasc/for-master' into 'master'

Some listview preparations

See merge request GNOME/gtk!1988

Fix inconsistencies in our pango deps

We were applying the pango version requirements inconsistently,
leading to different pango variables being taking from system
pango vs the subproject at times. Thankfully, meson detects
this and complains, so we can fix it.

Merge branch 'fix-gesture-leak' into 'master'

gesture: Don't leak target widgets

Closes #2801

See merge request GNOME/gtk!1986

widget: Add gtk_widget_get_size()

A little bit of convenience.

wayland: Remove function declaration for nonexisting function

builder: Allow <property bind /> for objects

Previously, object properties had to always be set to a value.
This now works without it.

Merge branch 'pango-bump-v2' into 'master'

pango version bump v2

See merge request GNOME/gtk!1987

Merge branch 'wip/jimmac/backdrop-assasination' into 'master'

Adwaita: limit scope of :backdrop

Closes #2694

See merge request GNOME/gtk!1978

Bump the pango dependency

We soon want to rely on the list model apis in
pango 1.45. This commit also fixes a mixup where
using pango as a submodule would break the build
when pangoft2 is required.

gesture: Don't leak target widgets

This was broken when we started tracking event targets
in dcbecdac31181854451e.

Fixes: #2801

CI: install a newer pango for MSYS2

Uses a build from git master from today

Merge branch 'matthiasc/for-master' into 'master'

eventcontroller: Fix crossing event scopes

See merge request GNOME/gtk!1983

Revert "Bump the pango dependency"

This reverts commit 98df0be43dea6ff61aadb28e1823b11a6d53452a.

It broke the win32 build.

eventcontroller: Fix crossing event scopes

We want to deliver crossing events to controllers
with scope same-native as long as at least one of
the targets is on the same native. As a new approach,
treat out-of-scope targets like NULL, and deliver
crossing events as long as one of the targets is
not NULL.

Add GTK_DEBUG=shortcuts

If the shortcuts debug flag is set, print out
shortcut activations.

meson: Cosmetics

Treat the display backend list like other lists in the summary.

Bump the pango dependency

We soon want to rely on the list model apis in
pango 1.45. This commit also fixes a mixup where
using pango as a submodule would break the build
when pangoft2 is required.

Merge branch 'matthiasc/for-master' into 'master'

Bring back gdk_display_put_event

See merge request GNOME/gtk!1980

Bring back gdk_display_put_event

It is still needed in WebKit.

Adwaita: limit scope of :backdrop

- most controls don't have:backdrop state
- different :backdrop state reserved for windows, headebars and toolbars
  and some buttons

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/2694

Merge branch 'im-context-key-forward' into 'master'

Add back keyboard related apis

See merge request GNOME/gtk!1977

Merge branch 'display-api' into 'master'

gdk: Make event-related apis private

See merge request GNOME/gtk!1929

Add gtk_im_context_filter_key

An event-less variant of the filtering api.

Update Catalan translation

Export keymap translation again

This is needed in WebKit webdriver test environment.

gdk: Make event-related apis private

Without a way to create events, there is no point
in allowing gdk_display_put_event to be used from
the outside. And little good can come out of using
the other apis, so just make them all private.

Merge branch 'frame-clock-alternative-approach-gtk4' into 'master'

Frame clock alternative approach for gtk4

See merge request GNOME/gtk!1932

frame-clock: Ensure we're always monotonic

A call to frame gdk_frame_clock_get_frame_time() outside of the paint
cycle could report an un-error-corrected frame time, and later a
corrected value could be earlier than the previously reported value.

We now always store the latest reported time so we can ensure
monotonicity.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!1976

tests: Disable idle locking in headless weston

In my local testing i was burned by the default 300sec value here.
I'm not sure if we actually hit this in the CI, but lets not
take any chances.

reftests: Fix frame inhibiting

Actually inhibit snapshotting of frames from reftest_inhibit_snapshot.
We were not ignoring the case where inhibit_count > 0, and then disconnected
the callback meaning we only ever got the first snapshot.

frame-clock: New approach in smoothing frame clock

In commit c6901a8b, the frame clock reported time was changed from
simply reporting the time we ran the frame clock cycle to reporting a
smoothed value that increased by the frame interval each time it was
called.

However, this change caused some problems, such as:
 https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1415
 https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1416
 https://gitlab.gnome.org/GNOME/gtk/-/merge_requests/1482

I think a lot of this is caused by the fact that we just overwrote the
old frame time with the smoothed, monotonous timestamp, breaking
some things that relied on knowing the actual time something happened.

This is a new approach to doing the smoothing that is more explicit.
The "frame_time" we store is the actual time we ran the update cycle,
and then we separately compute and store the derived smoothed time and
its period, allowing us to easily return a smoothed time at any time
by rounding the time difference to an integer number of frames.

The initial frame_time can be somewhat arbitrary, as it depends on the
first cycle which is not driven by the frame clock. But follow-up
cycles are typically tied to the the compositor sending the drawn
signal. It may happen that the initial frame is exactly in the middle
between two frames where jitter causes us to randomly round in
different directions when rounding to nearest frame. To fix this we
additionally do a quadratic convergence towards the "real" time,
during presentation driven clock cycles (i.e. when the frame times are
small).

frame clock: Use compositor refresh rate info even if presentation time not set

On my X11 + nvidia setup gnome-shell doesn't report presentation times.
However it does report refresh rate. We were mostly using this in our
calculation except when computing predicted presentation time, were
it fell back on the default 60Hz.

frame clock: Used drawn_time (as well as presentation time) in profiler marks.

FrameClock debug: Log drawn_time if set

shortcut controller: Fix mnemonic cycling

Iterate the shortcuts we found in order, not in
reverse. Otherwise, we always end up activating
the last_selected one, since it is last in the
list.

This broke in fb9b54d4b209afc when a list was
turned into an array.

widget-factory: Add a mnemonic conflict

Make Alt-e the mnemionic for both the Edit menu
and the Select button on page 2. This shows that
mnemonic cycling doesn't currently work, we always
open the menu.

Update Ukrainian translation

Merge branch 'fix_typos' into 'master'

Fix minor typos

See merge request GNOME/gtk!1974

Fix minor typos

Merge branch 'matthiasc/for-master' into 'master'

a11y: Widgets have children

See merge request GNOME/gtk!1973

a11y: Widgets have children

This brings back some of what we lost when
GtkContainerAccessible went away.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!1972

aboutdialog: Stop overriding show()

This is entirely unnecessary.

volumebutton: Enable the tooltips

Little point in having a query-tooltip handler if
we don't make sure ::query-tooltip is emitted.

volumebutton: Remove broken a11y code

The accessible of a button is not an AtkImage,
so whatever this code was trying to do isn't
working. Remove it.

tooltips: Fix a line wrap mishap

We don't want wrapping labels to cause tooltips to
have excessive height, so we need to set a reasonable
value for width-chars, without forcing short tooltips
into a full line length. Also be careful to respect
preexisting line breaks (we have such examples in
widget factory).

Merge branch 'ebassi/overlay-docs' into 'master'

Ebassi/overlay docs

See merge request GNOME/gtk!1970

Merge branch 'matthiasc/for-master' into 'master'

Add to the docs README

See merge request GNOME/gtk!1971

Add to the docs README

Mention markdown syntax and gtk-doc additions.

Remove spurious annotations

Boolean values are not nullable, and have no ownership to transfer.

Add missing documentation for GtkOverlayLayout

We're missing the documentation for the constructor, and for the child
properties.

Merge branch 'ebassi/howto-docs' into 'master'

Ebassi/howto docs

See merge request GNOME/gtk!1969

docs: Link the documentation guidelines

From the coding style.

Add the beginnings of a docs contribution guide

We have one for the whole project, but the documentation should have a
proper introduction and a proper style guide.

Add myself to more sections

docs: Remove last two steps from the release howto

Drop the GTK list announcements, as we don't have lists any more.

The GTK website updates itself automatically, these days.

docs: Turn coding style into a markdown document

It was mostly one already, just needed some minor fixes.

Merge branch 'carlosgc/fix-build' into 'master'

build: add gtkoverlaylayout.h to the list of public headers

See merge request GNOME/gtk!1968

build: add gtkoverlaylayout.h to the list of public headers

GtkOverlayLayout is now public but the header is not installed.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!1967

win32: Drop an unsed variable

gdk: Drop no-longer-used documentation

Thread support is gone, and we don't have that
section in the docs anymore.

gdk: Remove an unused texture api

gdk_gl_texture_from_surface wasn't used anywhere,
so lets drop it.

gdk: Drop some unused event queue functions